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About This Manual 

This manual describes the TMS320C3x peripheral control library—a 
collection of data structures and macros for controlling the ’C3x bus control 
peripherals, DMA, serial ports, and timers via the C programming language. 


How to Use This Manual 


This document contains the following chapters: 


Chapter 1: 
Chapter 2: 

Chapter 3: 


Overview. Describes the features of the library files. 

TMS320C3x Peripheral Set. Describes the header files, 
macros, and pointers for the ’C3x peripherals. 

TMS320C3x Peripheral Control Example. Illustrates how 
the ’C3x Peripheral Control Library can be used to program 
a ’C3x serial port. 


Appendix A: Tables of Peripheral Registers, Structure-Member 
Names, and Bit-Field Names. Provides examples and 
tables listing the names used to access each of the peripheral 
registers and bit fields through C-peripheral pointers. 


Appendix B: Header Files. Includes bus30.h, dma30.h, serprt30.h, and 
timer30.h header file listings. 


Style and Symbol Conventions 

This document uses the following conventions. 

□ Program listings, program examples, interactive displays, filenames, and 
symbol names are shown in a special typeface similar to a 
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Style and Symbol Conventions 


typewriter’s. Examples use a bold version of the special typeface for 
emphasis; interactive displays use a bold version of the special 
typeface to distinguish commands that you enter from items that the 
system displays (such as prompts, command output, error messages, 
etc.). 

Here is a sample program listing: 


0011 

0005 

0001 

.field 

1 , 

2 

0012 

0005 

0003 

.field 

3, 

4 

0013 

0005 

0006 

.field 

6, 

3 

0014 

0006 


. even 




Here is an example of a system prompt and a command that you might 
enter: 

C: csr -a /user/ti/simuboard/utilities 

□ In syntax descriptions, the instruction, command, or directive is in a bold 
typeface font and parameters are in an italic typeface. Portions of a syntax 
that are in bold should be entered as shown; portions of a syntax that are 
in italics describe the type of information that should be entered. Here is 
an example of a directive syntax: 

.asect ” section name”, address 

.asect is the directive. This directive has two parameters, indicated by 
section name and address. When you use .asect, the first parameter must 
be an actual section name, enclosed in double quotes; the second 
parameter must be an address. 

□ Square brackets ([ and ]) identify an optional parameter. If you use an 
optional parameter, you specify the information within the brackets; you 
don’t enter the brackets themselves. Here’s an example of an instruction 
that has an optional parameter: 

LALK 16-bit constant [, shift] 

The LALK instruction has two parameters. The first parameter, 16-bit 
constant, is required. The second parameter, shift, is optional. As this 
syntax shows, if you use the optional second parameter, you must 
precede it with a comma. 

Square brackets are also used as part of the pathname specification for 
VMS pathnames; in this case, the brackets are actually part of the 
pathname (they are not optional). 

□ Braces ( {and} ) indicate a list. The symbol | (read as or) separates items 
within the list. Here’s an example of a list: 

{ * I *+ I *- } 
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This provides three choices: *, *+, or 

Unless the list is enclosed in square brackets, you must choose one item 
from the list. 

□ Some directives can have a varying number of parameters. For example, 
the .byte directive can have up to 100 parameters. The syntax for this 
directive is: 

.byte value-i [,..., value n ] 

This syntax shows that .byte must have at least one value parameter, but 
you have the option of supplying additional value parameters, separated 
by commas. 


Related Documentation From Texas Instruments 

TMS320 Floating-Point DSP Assembly Language Tools User’s Guide 

(literature number SPRU035) describes the assembly language tools 
(assembler, linker, and other tools used to develop assembly language 
code), assembler directives, macros, common object file format, and 
symbolic debugging directives for the ’C3x and ’C4x generations of 
devices. 

TMS320 Floating-Point DSP Optimizing C Compiler User’s Guide 

(literature number SPRU024) describes the TMS320 floating-point C 
compiler. This C compiler accepts ANSI standard C source code and 
produces TMS320 assembly language source code for the ’C3x and 
’C4x generations of devices. 

TMS320C3x User’s Guide (literature number SPRU031) describes the ’C3x 
32-bit floating-point microprocessor, developed for digital signal 
processing as well as general applications. Covered are its architecture, 
internal register structure, instruction set, pipeline, specifications, and 
operation of its DMA and its two serial ports. Software and hardware 
applications are included. 

TMS320C40 Parallel Runtime Support Library User’s Guide (literature 
number SPRU084) describes the ’C40 Parallel Runtime Support Library, 
a standard method of programming the ’C40 peripherals at the register 
and bit level via the C programming language. Library and header files, 
a summary of parallel runtime support functions and macros, a functions 
reference, and a listing of header files are included. 
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If You Need Assistance 


If You Need Assistance... 


If you want to... 

Do this... 

Request more information about 
Texas Instruments Digital Signal 
Processing (DSP) products 

Call the CRCt: 

(214) 995-6611 

Or write to: 

Texas Instruments Incorporated 

Market Communications Manager, MS 736 

P.O. Box 1443 

Houston, Texas 77251-1443 

Order Texas Instruments 
documentation 

Call the CRCt: 

(214) 995-6611 

Ask questions about product 
operation or report suspected 
problems 

Call the DSP hotline: 

(713) 274-2320 

Report mistakes in this document 
or any other Tl documentation 

Fill out and return the reader response card at 
the end of this book, or send your comments to: 
Texas Instruments Incorporated 

Technical Publications Manager, MS 702 

P.O. Box 1443 

Houston, Texas 77251-1443 


t Texas Instruments Customer Response Center 


VI 








Contents 


1 Overview. 

2 TMS320C3X Peripheral Set . 

2.1 Header Files . 

2.2 Macros. 

2.3 Pointers . 

3 TMS320C3x Peripheral Control Example . 

A Tables of Peripheral Registers, Structure-Member Names, and Bit-Field Names 

B Header Files . 

B.1 bus30.h Header File . 

B.2 dma30.h Header Files. 

B.3 serprt30.h Header Files . 

B.4 timer30.h Header File . 


0 

El 

2^2 

243 

2-4 


A-1 


B-1 


B-2 


B-5 


B-7 

14 


Contents 


VII 
































Tables 


A-1 Bus-Control Registers . 

A-2 DMA-Control Registers .... 

A-3 Serial-Port-Control Registers 

A-4 Timer-Control Registers .... 


/V2 
A -2 
A^3 

A-6 











Examples 


2-1 Declaring a Peripheral Pointer. 

2- 2 Two Methods of Setting Control Registers 

3- 1 Configuring a TMS320C3x Serial Port ... 

A-1 Bus Control . 

A-2 DMA-Control Registers . 

A-3 Serial Port Control . 

A-4 Timer Control. 


: 

±2 

A-2 

A-2 

A-5 

A-6 


Contents 


IX 

















Chapter 1 


Overview 


This user’s guide describes the TMS320C3x Peripheral Control Library, a 
standard for controlling ’C3x peripherals using the C programming language. 
The library, part of theTMS320 Floating-Point DSP Optimizing C Compiler, of¬ 
fers consistency in naming and accessing variables, thereby reducing devel¬ 
opment time for new code and facilitating code maintenance. 

Because all the ’C3x peripherals and their corresponding registers are 
memory-mapped, a device’s peripheral can be controlled easily from C code. 
The flexibility of the C language allows structures to be defined for modifying 
’C3x peripheral memory-mapped registers. Furthermore, because many of 
the peripheral control registers use individual bit locations to define functional¬ 
ity, bit fields are implemented in this standard with C bit-field structures. 

By utilizing this standard for controlling ’C3x peripherals, you can develop cus¬ 
tom support libraries that are both portable and readable. 

This document describes the TMS320C3x peripheral registers and their struc¬ 
ture member names and gives examples on how to utilize the library. 
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Chapter 2 


TMS 320 C 3 x Peripheral Set 


The TMS320C3x peripherals include external buses, direct memory access 
(DMA), two serial ports, and two timers. The on-chip integration of all of these 
peripherals increases processor performance and overall system hardware 
integration. Each application has different peripheral requirements and config¬ 
urations that must be programmed before you use the peripheral. The periph¬ 
erals are configured by writing values to the corresponding control register. For 
example, the following nondescriptive C statement starts timer 0 by writing a 
value of 0x2C1 into the timer 0 global control register at address 0x808020: 

* (unsigned int *)0x808020 = 0x2Cl; 

The ’C3x Peripheral Control Library simplifies writing more readable C code 
and helps make the DSP code consistent from one application to the next. 

This chapter discusses these topics: 


Topic 


2.1 

Header Files . 

2.2 

Macros. 

2.3 

Pointers. 


Page 
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2-3 


2-4 
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Header Files 


2.1 Header Files 

The ’C3x Peripheral Control Library consists of four header files: 

□ bus30.h 

□ dma30.h 

□ serprt30.h 

□ timer30.h 

The header files declare structures and macros. In particular, each header file 
declares: 

□ Data structures for the peripheral’s memory mapping 

□ Data structures for the bit fields of the peripheral’s control registers 

□ Macros for declaring pointers to the peripherals 

□ Macros for bit field assignment 

Before using a peripheral macro or data structure, you must include the ap¬ 
propriate header file in the program, as shown below. 

#include <timer30.h> 


TIMER_ADDR(0)->gcontrol=0x0 ; 
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Macros 


2.2 Macros 


Four macros facilitate the assignment of C pointers to the four peripherals: 

□ BUS_ADDR 

□ DMA_ADDFt 

□ SERIAL_PORT_ADDR(n) 

□ TIMER_ADDR(n) 

These macros assign C symbols to the peripheral base addresses and type¬ 
cast the memory location to point to the peripheral data structure. For exam¬ 
ple, BUS_ADDR is defined as follows: 

#define BUS_ADDR ((volatile BUS_REG *)((char *) BUS_BASE)) 

where bus_reg is the data structure describing the bus control register 
memory mapping (discussed in the next section) and bus_base is 0x808060. 


TMS320C3x Set 
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Pointers 


2.3 Pointers 


Pointers to peripherals are then used to access the peripheral control regis¬ 
ters. Peripheral pointers point to data structures that represent the mapping 
of the peripheral control registers. The four data structures are: 

□ BUS_REG 

□ DMA_REG 

□ SERIAL_PORT_REG 

□ TIMER_REG 

For example, the ’C3x memory map of the timer control registers described in 
Figure 2-1 is defined in C with the TIMER_REG data structure that follows the 
figure: 

Figure 2-1. Memory-Mapped Timer Locations 


Register Peripheral Address 

Timer 0 Timer 1 


Timer Global Control 

808020h 

808030h 

Reserved 

808021h 

808031h 

Reserved 

808022h 

808032h 

Reserved 

808023h 

808033h 

Timer Counter 

808024h 

808034h 

Reserved 

808025h 

808035h 

Reserved 

808026h 

808036h 

Reserved 

808027h 

808037h 

Timer Period 

808028h 

808038h 

Reserved 

808029h 

808039h 

Reserved 

80802Ah 

80803Ah 

Reserved 

80802Bh 

80803Bh 

Reserved 

80802Ch 

80803Ch 

Reserved 

80802Dh 

80803Dh 

Reserved 

80802Eh 

80803Eh 

Reserved 

80802Fh 

80803Fh 
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Pointers 


typedef struct 
{ 

TIMER_CONTROL 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
} TIMER_REG; 


_gtrl; /* Timer global control */ 

reservedl[3]; /* 3 reserved locations */ 

counter; /* Timer counter */ 

reserved2[3] /* 3 more reserved locations */ 
period; /* Time period */ 


Because the peripheral control registers can change independently of the 
CPU, peripheral pointers should be declared by using the volatile-data type 
qualifier. Example 2-1 shows howto use the TIMER_REG data structure 
and the TIMER_ADDR(n) macro to assign *timerO_ptr to point to timer 0. 

Example 2-1. Declaring a Peripheral Pointer 

volatile TIMER_REG *timerO_ptr = TIMER_ADDR(0); 

The peripheral control registers can be set one bit at a time or by assigning an 
integer value to the register. Example 2-2 shows how to use both integer and 
bit-field methods for halting timer 0 by setting the HLD bit of the timer global 
control register to zero. This example uses the timer pointer from 
Example 2-1. To aid in these operations, descriptive macros for both bit-field 
and integer manipulations are defined in the header files. 

Example 2-2. Two Methods of Setting Control Registers 

Integer Method: timerO_ptr->gcontrol &= -0x80 

Bit-Field Assignment Method: timer0_ptr—>gcontrol_bit.hld_ = 0 


TMS320C3x Peripheral Set 


2-5 



Chapter 3 


TMS 320 C 3 x Peripheral Control Example 


This chapter illustrates how you can use the ’C3x Peripheral Control Library 
to program the ’C3x serial port 0 via several combined methods of setting up 
the control registers. 

Consider the following configuration of serial port 0: 

□ Generate the bit clock at 8M bits per second (assuming a 32-MHz input 
clock) 

□ Generate frame sync pulses 

□ Transmit/receive 32-bit data 

□ Operate in standard/fixed mode 

□ Generate interrupts on data transmitted 

To obtain this configuration, you must set the serial port registers accordingly: 


Register 

Address 

Value 

Global Control 

0x808040 

0xCBC00C4 

FSX/DX/CLKX Port Control 

0x808042 

0x111 

FSR/DR/CLKR Port Control 

0x808043 

0x111 

Rec/Trans Timer Control 

0x808044 

0x3CF 


Example 3-1 illustrates how this configuration is achieved with the ’C3x Pe¬ 
ripheral Control Library. The control segment is highly readable and produces 
efficient assembly code when compiled. 


3-1 




TMS320C3x Peripheral Control Example 


Example 3-1. Configuring a TMS320C3x Serial Port 

#include <serprt30.h> 


/* define a pointer to serial port 0 */ 

volatile SERIAL_PORT_REG *spO = SERIAL_PORT_ADDR(0); 


/* set serial port 0's fsr/dr/clkr port control register by integer assignment */ 

SERIAL_PORT_ADDR(0)->s_r_control = Oxlll; 

/* set serial port 0's fsx/dx/clkx port control register by integer 
assignment using descriptive macros*/ 

spO->s_x_control = CLKXFUNC | DXFUNC | FSXFUNC; 

/* set serial port 0's global control register by bit field assignment*/ 

SERIAL_PORT_ADDR(0)->global_bit.fsxout = 1; 
spO->global_bit.xclksrce = 1; 
spO->global_bit.rclksrce = 1; 
spO->global_bit.xlen = XLEN_32; 
spO->global_bit.rlen = RLEN_32; 
spO->global_bit.xint = 1; 
spO->global_bit.xreset = 1; 
spO->global_bit.rreset = 1; 

/* set serial port 0's rec/transm timer control register */ 

spO->s_rxt_control = XGO | HLD_ | XCP_ | 

XCLKSRC | RGO | RHLD_ | RCP_ | RCLKSRC; 
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Appendix A 


Tables of Peripheral Registers, 
Structure-Member Names, and Bit-Field Names 


The TMS320C3x Peripheral Control Library provides C data structures for 
manipulating the TMS320C3x peripherals. The following tables list the data 
structure member names used to access each of the peripheral registers and 
bit fields through C peripheral pointers. Refer to the TMS320C3x User’s Guide 
for a detailed explanation of the registers and bit-field descriptions. The first 
entry for each register shows how to access that register as an integer. The 
remaining entries show how to access the register’s bitfields individually. Each 
table is followed by an example. 

This appendix includes these tables: 


Topic Page 


Table A-1 

Bus Control . 

. EH 

Table A-2 

DMA Control . 

. El 

Table A-3 

Serial Port Control. 

. El 

Table A-4 

Timer Control . 

. El 
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Tables of Peripheral Registers, Structure-Member Names, and Bit-Field Names 


Table A-1. Bus-Control Registers 


’C3x Register 

Assignment 

Bit Field 

Member Name 

Primary Bus Control 

Integer assignment 

— 

->prim_gcontrol 

Bit-field assignment 

BNKCMP 

->prim_gcontrol_bit.bnkcmp 

HIZ 

->prim_gcontrol_bit.hiz 

HOLDST 

->prim_gcontrol_bit.holdst 

NOHOLD 

->prim_gcontrol_bit. nohold 

SWW 

->prim_gcontrol_bit.sww 

WTCNT 

->prim_gcontrol_bit.wtcnt 

Expansion Bus Control 

Integer assignment 

— 

->exp ^control 

Bit-field assignment 

SWW 

->exp_gcontrol_bit.sww 

WTCNT 

->exp_gcontrol_bit.wtcnt 


Example A-1. Bus Con trot 

#include<bus30.h> 

volatile BUS_REG *bus_ptr=BUS_ADDR; /* define pointer to bus peripheral */ 

bus_ptr->exp_gcontrol=0; /* zero wait states on expansion bus */ 


Table A-2. DMA-Control Registers 


’C3x Register 

Assignment 

Bit Field 

Member Name 

DMA Global Control 

Integer assignment 

— 

->gcontrol 

Bit-field assignment 

DECSRC 

->gcontrol_bit.decsrc 

DECDST 

->gcontrol_bit.decdst 

INCDST 

->gcontrol_bit.incdst 

INCSRC 

->gcontrol_bit.incsrc 

START 

->gcontrol_bit.start 

STAT 

->gcontrol_bit.stat 

SYNC 

->gcontrol_bit.sync 

TC 

->gcontrol_bit.tc 

TCINT 

->gcontrol_bit.tcint 

DMA Source Address 

Integer assignment 

— 

->source 

DMA Destination Address 

Integer assignment 

— 

->destination 

DMA Transfer Counter 

Integer assignment 

— 

->transfer_counter 


Example A-2. DMA-Control Registers 

#include <dma30.h> 

volatile DMA_REG *dma=DMA_ADDR; /* define pointer to dma */ 

dma->gcontrol_bit.start=STOP; /* stop the dma by setting the start bits*/ 
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Tables of Peripheral Registers, Structure-Member Names, and Bit-Field Names 


Table A-3. Serial-Port-Control Registers 


’C3x Register 

Assignment 

Bit Field 

Member Name 

Serial Port Global Control 

Integer assignment 

— 

->gcontrol 


Bit-field assignment 

CLKRP 

->gcontrol_bit.clkrp 



CLKXP 

->gcontrol_bit.clkxp 



DRP 

->gcontrol_bit.drp 



DXP 

->gcontrol_bit.dxp 



FSRP 

->gcontrol_bit.fsrp 



FSXP 

->gcontrol_bit.fsxp 



FSXOUT 

->gcontrol_bit.fsxout 



HS 

->gcontrol_bit.hs 



RCLKSRCE 

->gcontrol_bit.rclksrce 



RFSM 

->gcontrol_bit.rfsm 



RINT 

->gcontrol_bit.rint 



RLEN 

->gcontrol_bit.rlen 



RRDY 

->gcontrol_bit.rrdy 



RRESET 

->gcontrol_bit.rreset 



RSRFULL 

->gcontrol_bit.rsrfull 



RUNT 

->gcontrol_bit.rtint 



RVAREN 

->gcontrol_bit.rvaren 



XCLKSRCE 

->gcontrol_bit.xclksrce 



XFSM 

->gcontrol_bit.xfsm 



XINT 

->gcontrol_bit.xint 



XLEN 

->gcontrol_bit.xlen 



XRDY 

->gcontrol_bit.xrdy 



XRESET 

->gcontrol_bit.xreset 



XSREMPTY 

->gcontrol_bit.xsrempty 



XTINT 

->gcontrol_bit.xtint 



XVAREN 

->gcontrol_bit.xvaren 
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Tables of Peripheral Registers, Structure-Member Names, and Bit-Field Names 


Table A-3. Serial-Port-Control Registers (Continued) 


’C3x Register 

Assignment 

Bit Field 

Member Name 

FSR/DR/CLKR Port Control 

Integer assignment 

— 

->s_r_control 

Bit-field assignment 

CLKRDATIN 

->s_r_control_bit.clkdati 

CLKRDATOUT 

->s_r_control_bit.clkdato 

CLKRFUNC 

->s_r_control_bit.clkfunc 

CLKRI/O 

->s_r_control_bit.clki_o 

DRDATIN 

->s_r_control_bit.ddatin 

DRDATOUT 

->s_r_control_bit.ddatout 

DRFUNC 

->s_r_control_bit.dfunc 

DRI/O 

->s_r_control_bit.di_o 

DRP 

->gcontrol_bit.drp 

FSRDATIN 

->s_r_control_bit.fsdatin 

FSRDATOUT 

->s_r_control_bit.fsdatout 

FSRFUNC 

-> s_r_co n t ro Ibit.fsfunc 

FSRI/O 

-> s_r_co n t ro l_b i t. f s i_o 

FSX/DX/CLKX Port Control 

Integer assignment 

— 

->s_x_control 

Bit-field assignment 

CLKXDATIN 

->s_x_control_bit.clkdati 

CLKXDATOUT 

->s_x_control_bit.clkdato 

CLKXFUNC 

->s_x_control_bit.clkfunc 

CLKXI/O 

->s_x_control_bit.clki_o 

DXDATIN 

->s_x_control_bit.ddatin 

DXDATOUT 

->s_x_control_bit.ddatout 

DXFUNC 

->s_x_control_bit.dfunc 

DXI/O 

->s_x_control_bit.di_o 

FSXDATIN 

->s_x_control_bit.fsdatin 

FSXDATOUT 

->s_x_control_bit.fsdatout 

FSXFUNC 

->s_x_control_bit.fsfunc 

FSXI/O 

-> s_x_co n t ro l_b i t. f s i_o 
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Tables of Peripheral Registers, Structure-Member Names, and Bit-Field Names 


Table A-3. Serial-Port-Control Registers (Concluded) 


C3x Register 

Assignment 

Bit Field 

Member Name 

Receive/Transmit Timer Control 

Integer assignment 

— 

->s_rxt_control 

Bit-field assignment 

RCLKSRC 

->s_rxt_control_bit.rclksrc 

RC/P 

->s_rxt_control_bit.rcp_ 

RGO 

->s_rxt_control_bit.rgo 

RHLD 

->s_rxt_control_bit.rhld_ 

RTSTAT 

->s_rxt_control_bit.rtstat 

XCLKSRC 

->s_rxt_control_bit.xclksrc 

XC/P 

->s_rxt_control_bit.xcp_ 

XGO 

->s_rxt_control_bit.xgo 

XHLD 

->s_rxt_control_bit.xhld_ 

XTSTAT 

->s_rxt_control_bit.xtstat 

Receive/Transmit Timer Counter 

Integer assignment 

— 

->s_rxt_counter 

Bit-field assignment 

Receive Counter 

->s_rxt_counter_bit.r_counter 

Transmit Counter 

->s_rxt_counter_bit.x_counter 

Receive/Transmit Timer Period 

Integer assignment 

— 

->s_rxt_period 

Bit-field assignment 

Receive Period 

->s_rxt_period_bit.r_period 

Transmit Period 

->s_rxt_period_bit.x_period 

Data Receive 

Integer assignment 

— 

r_data 

Data Transmit 

— 

x_data 


Example A-3. Serial Port Control 

#include <serprt30.h> 

volatile SERIAL_PORT_REG *spl=SERIAL_PORT_ADDR(1); /* define pointer to serial port 1 */ 

spl-> x_data= uncompress(x); /* write out result */ 
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Tables of Peripheral Registers, Structure-Member Names, and Bit-Field Names 


Table A-4. Timer-Control Registers 


’C3x Register 

Assignment 

Bit Field 

Member Name 

Timer Global Control 

Integer assignment 

— 

->gcontrol 

Bit-field assignment 

CLKSRC 

->gcontrol_bit.clksrc 

C/P 

->gcontrol_bit.cp_ 

DATIN 

->gcontrol_bit.datin 

DATOUT 

->gcontrol_bit.datout 

FUNC 

->gcontrol_bit.func 

GO 

->gcontrol_bit.go 

HLD 

->gcontrol_bit.hld_ 

INV 

->gcontrol_bit.inv 

I/O 

->gcontrol_bit.i_o 

TSTAT 

->gcontrol_bit.tstat 

Timer Counter 

Integer assignment 

— 

->counter 

Timer Period 

— 

->period 


Example A-4. Timer Control 

#include<timer30.h> 

volatile TIMER_ADDR(0)->gcontrol=0; /* stop timer */ 

/* determine remaining time */ 

int time_remain=TIMER_ADDR(0)->period-TIMER_ADDR(0)->counter 
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Appendix B 


Header Files 


This appendix lists the bus30.h, dma30.h, serprt30.h, and timer30.h header 
files: 

Topic Page 

B.1 bus30.h Header File. HI 

B.2 dma30.h Header File . ^-5| 

B.3 serprt30.h Header File. fc-7| 

B.4 timer30.h Header File. fe-14| 
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bus30.h Header File 


B.1 bus30.h Header File 


/-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

/* bus30.h v4.5 

/* Copyright (c) 1991 Texas Instruments 

! ■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

#ifndef _BUS30 
#define _BUS30 


•k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-kj 

*/ 

Incorporated */ 

•k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k/ 


#define 
#define 
#define 
#define 


exp_gcontrol 

exp_gcontrol_bit 

prim_gcontrol 

prim_gcontrol_bit 


.egctrl ,_intval 
.egctrl ,_bitval 
.pgctrl ._intval 
.pgctrl ,_bitval 


/ 'k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-kJ 

/* MACRO DEFINITION FOR BUS BASE ADDRESS */ 

! ■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-kj 

#define BUS_BASE 0x808060 

#define BUS_ADDR ((volatile BUS_REG *) ((char *) BUS_BASE)) 


/**************************************************************************/ 
/* STRUCTURE DEFINITION FOR PRIM AND EXP BUS GLOBAL CONTROL REGISTERS */ 

J-k-k-k-k-k-k'k-k-k-k'k-k-k-k'k-k-k-k-k-k-k-k-k-k-k-k'k-k-k-k'k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k'k-k-k-k-k-k-k-k-k-k-k-kJ 

typedef union 

{ 

unsigned int _intval; 
struct 
{ 


unsigned 

int 

holdst 

l; 

/* Hold status bit 

*/ 

unsigned 

int 

nohold 

l; 

/* Port hold signal 

*/ 

unsigned 

int 

hiz 

l; 

/* Internal hold 

*/ 

unsigned 

int 

sww 

2; 

/* S/W wait mode 

*/ 

unsigned 

int 

wtcnt 

3; 

/* S/W wait count 

*/ 

unsigned 

int 

bnkcmp 

5; 

/* Bank compare 

*/ 

unsigned 

int 

r_rest 

19; 

/* reserved 

*/ 


} _bitval; 

} PRIMARY_BUS_CONTROL; 

typedef union 

{ 

unsigned int _intval; 
struct 
{ 

unsigned int 
unsigned int 
unsigned int 
unsigned int 
} _bitval; 

} EXPANSION_BUS_CONTROL; 


r_012 
sww 
wtcnt 
r rest 


3; 

2 ; 

3; 

24; 


/* reserved */ 
/* S/W wait mode */ 
/* S/W wait count */ 
/* reserved */ 
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/*-k-kk*-k-k-k-k-k-k*-kk*k-k-k-kk-k-k*k-k-k-kk-k-k-k-k-kk*k*-k*k-k-k*-k*-k-k*-k-k-kk-kk*k-k-k*k-k-k*k-k-k-k*-k-k*-k-k-k/ 

/* STRUCTURE DEFINITION FOR BUS REGISTERS */ 

/**************************************************************************/ 


typedef struct 

{ 

EXPANSION_BUS_CONTROL _egctrl; 
unsigned int reservedl[3] 

PRIMARY_BUS_CONTROL _pgctrl; 

} BUS_REG; 


/* Exapansion 

bus 

control 

register 

*/ 



/* 

reserved 

*/ 

/* Primary 

bus 

control 

register 

*/ 


/**************************************************************************/ 
/* BUS MACROS FOR BIT FIELD DEFINITIONS */ 

/**************************************************************************/ 


/* Bus macros for global control registers integer assignments 
/* e.g. BUS_ADDR->prim_gcontrol = EXTERNAL_RDY | WS_1; sets the 
/* corresponding bits of the primary bus control register. 

/■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 


tdefine HOLDST Oxl 

#define NOHOLD 0x2 

tdefine HIZ 0x4 

tdefine EXTERNAL_RDY 0x00 
tdefine INTERNAL_RDY 0x08 
tdefine OR_EXT_INT 0x10 

tdefine AND_EXT_INT 0x18 

tdefine WS_0 0x00 

tdefine WS_1 0x20 

tdefine WS_2 0x40 

tdefine WS_3 0x60 

tdefine WS_4 0x80 

tdefine WS_5 OxAO 

tdefine WS_6 OxCO 

tdefine WS_7 OxEO 

tdefine BANK_16M 0x00 

tdefine BANK_8M 0x100 

tdefine BANK_4M 0x200 

tdefine BANK_2M 0x300 

tdefine BANK_1M 0x400 

tdefine BANK_512K 0x500 

tdefine BANK_256K 0x600 

tdefine BANK_128K 0x700 

tdefine BANK_64K 0x800 

tdefine BANK_32K 0x900 

tdefine BANK_16K OxAOO 

tdefine BANK_8K OxBOO 

tdefine BANK_4K OxCOO 

tdefine BANK_2K OxDOO 

tdefine BANK_1K OxEOO 

tdefine BANK_512 OxFOO 

tdefine BANK_256 0x1000 


*/ 

*/ 

*/ 

*/ 
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/**************************************************************************/ 
/* Bus macros for global control registers bit field assignments */ 

/* e.g. BUS_ADDR->prim_gcontrol_bit.sww = AND_RDY; */ 

/* BUS_ADDR->exp_gcontrol_bit.wtcnt = WAIT_2; */ 

/* sets the appropriate bits of bus control registers. */ 

/**************************************************************************/ 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define WAIT 
#define WAIT 


HOLD 

INT_RDY 

EXT_RDY 

OR_RDY 

AND_RDY 

BANK_SIZE_ 

BANK_SIZE_ 

BANK_SIZ E_ 

BANK_SIZ E_ 

BANK SIZE 


16M 

8M 

4M 

2M 

1M 


BANK_SIZ E_512 K 

BANK_SIZ E_2 5 6 K 

BANK_SIZ E_12 8 K 

BANK_SIZE_64K 

BANK_SIZ E_3 2 K 

BANK_SIZ E_1 6 K 

BANK_SIZ E_8 K 

BANK_SIZ E_4 K 

BANK_SIZ E_2 K 

BANK_SIZ E_1K 

BANK_SIZ E_512 

BANK_SIZ E_2 5 6 

0 
1 


#define WAIT_2 
#define WAIT_3 
#define WAIT_4 
#define WAIT_5 
#define WAIT_6 
#define WAIT_7 


1 

0 

1 

2 

3 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

0 

1 

2 

3 

4 

5 

6 
7 


#endif /* #ifndef _BUS30 */ 
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B.2 dma30.h Header Files 


/ 


■^'k-k-k^c'k-k-k-k'k-k-k-k-k-k-k-k'k-k-k-k-k-k-k-k'k-k-k-k-k-k-k-k'k-k-k^c-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 


/ 


/* dma30.h v4.5 */ 

/* Copyright (c) 1991 Texas Instruments Incorporated */ 

/*****************************************************************************/ 
tifndef _DMA30 
#define _DMA30 


tifndef gcontrol 
tdefine gcontrol 
tendif 


_gctrl._intval 


tifndef gcontrol_bit 

tdefine gcontrol_bit _gctrl,_bitval 

tendif 


/ 


•k'k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k^c'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k^c'k'k'k'k'k'k'k'k'k'k'k^c-k-k-k^c-k-k'k-k'k 


/* MACRO DEFINITIONS FOR DMA BASE ADDRESS */ 

/**************************************************************************/ 
tdefine DMA_BASE 0x808000 

tdefine DMA_SIZE 16 

tdefine DMA_ADDR ((volatile DMA_REG *) ((char *) DMA_BASE)) 


/I********-************************-********-****************-****************-**/ 

/* STRUCTURE DEFINITION FOR DMA GLOBAL CONTROL REGISTER */ 

/**************************************************************************/ 
typedef union 
{ 

unsigned int _intval; 
struct 
{ 


unsigned 

int 

start 

2; 

/* Start/Stop control 

*/ 

unsigned 

int 

stat 

2; 

/* DMA status 

*/ 

unsigned 

int 

incsrc 

l; 

/* Increment source addr ON/OFF 

*/ 

unsigned 

int 

decsrc 

l; 

/* Decrement source addr ON/OFF 

*/ 

unsigned 

int 

incdst 

l; 

/* Increment dest addr ON/OFF 

*/ 

unsigned 

int 

decdst 

l; 

/* Increment dest addr ON/OFF 

*/ 

unsigned 

int 

sync 

2; 

/* Source/dest synchronization 

*/ 

unsigned 

int 

tc 

l; 

/* Transfer terminate control 

*/ 

unsigned 

int 

tcint 

l; 

/* DMA interrupt to CPU control 

*/ 

unsigned 
bitval; 

int 

r_rest 

20; 

/* reserved 

*/ 


} DMA_CONTROL; 

/**************************************************************************/ 
/* STRUCTURE DEFINITION FOR DMA REGISTERS */ 

/**************************************************************************/ 
typedef struct 
{ 


DMA_CONTROL 

_gctrl; 

/* Global 

control 

register 

*/ 

unsigned 

int 

reservedl[3]; 


/* 

reserved 

*/ 

unsigned 

int 

source; 

/* Source 

address 

register 

*/ 

unsigned 

int 

reserved2[1]; 


/* 

reserved 

*/ 

unsigned 

int 

destination; 

/* Destination 

address 

register 

*/ 

unsigned 

int 

reserved3[1]; 


/* 

reserved 

*/ 

unsigned 

int 

transfer_counter; 

/* Transfer 

counter 

register 

*/ 


} DMA_REG; 
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/**************************************************************************/ 
/* DMA MACROS FOR BIT FIELD DEFINITIONS */ 

/**************************************************************************/ 
/* DMA macros for global control register integer assignments */ 

/* e.g. DMA_ADDR->gcontrol = STARTO | SYNC1 | TCINT sets the corresponding*/ 
/* bits of the DMA global control register */ 

/**************************************************************************/ 


#define 

STARTO 

0x0 

#define 

START1 

0x1 

#define 

START2 

0x2 

#define 

START3 

0x3 

#define 

STATO 

0x0 

#define 

STAT1 

0x4 

#define 

STAT2 

0x8 

#define 

STAT3 

OxC 

#define 

INCSRC 

0x10 

#define 

DECSRC 

0x20 

#define 

INCDST 

0x40 

#define 

DECDST 

0x80 

#define 

SYNCO 

0x00 

#define 

SYNC1 

0x100 

#define 

SYNC2 

0x200 

#define 

SYNC3 

0x300 

#define 

TC 

0x400 

#define 

TCINT 

0x800 


/**************************************************************************/ 


/* DMA macros for global control register bit field assignments */ 
/* e.g. DMA_ADDR->gcontrol.incsrc = INCREMENT; */ 
/* e.g. DMA_ADDR—>gcontrol.incdst = INCREMENT; */ 
/* sets the appropriate bits of the DMA global control register */ 


/**************************************************************************/ 


#define 

INCREMENT 

1 

#define 

DECREMENT 

1 

#define 

TERMINATE 

1 

#endif 

/* #ifndef 

_DMA3 0 
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B.3 serprt30.h Header Files 


/************************************** 
/* serprt30.h v4.5 

/* Copyright (c) 1991 Texas Instruments 
/ '************************************** 
#ifndef _SERPRT30 
#define _SERPRT30 


*************************************** j 

*/ 

Incorporated */ 

*************************************** j 


tifndef gcontrol 

tdefine gcontrol _gctrl,_intval 

tendif 


tifndef gcontrol_bit 

tdefine gcontrol_bit _gctrl._bitval 

tendif 


tdefine 

tdefine 

tdefine 

tdefine 

tdefine 

tdefine 

tdefine 

tdefine 

tdefine 

tdefine 


s_x_control 

s_x_control_bit 

s_r_control 

s_r_control_bit 

s_rxt_control 

s_rxt_control_bit 

s_rxt_counter 

s_rxt_counter_bit 

s_rxt_period 

s_rxt_period_bit 


xctrl._intval 
.xctrl,_bitval 
.rctrl ,_intval 
.rctrl ._bitval 
.rxtctrl ,_intval 
.rxtctrl ._bitval 
rxtcounter,_intval 
rxtcounter,_bitval 
.rxtperiod,_intval 
.rxtperiod._bitval 


y**************************************************************************/ 
/* MACRO DEFINITIONS FOR SERIAL PORT BASE ADDRESS */ 
y**************************************************************************y 


tdefine SERIAL_PORT_ZERO 
tdefine SERIAL_PORT_ONE 
tdefine SERIAL_PORT_BASE 
tdefine SERIAL_PORT_SIZE 
tdefine SERIAL_PORT_ADDR(n) 


0 

1 

0x808040 

16 

((volatile SERIAL_PORT_REG *) ((char *) \ 
SERIAL_PORT_BASE + (n)*SERIAL_PORT_SIZE)) 


B-7 


serprt30.h Header Files 


/**************************************************************************/ 
/* STRUCTURE DEFINTION FOR SERIAL PORT GLOBAL CONTROL REGISTER */ 

/**************************************************************************/ 
typedef union 
{ 

unsigned int _intval; 
struct 
{ 


unsigned 

int 

rrdy 

l; 



/* Receive ready flag 

*/ 

unsigned 

int 

xrdy 

l; 



/* Transmitt ready flag 

*/ 

unsigned 

int 

fsxout 

l; 



/* FSX configuration 

*/ 

unsigned 

int 

xsrempty 

l; 



/* Transm shift reg empty 

*/ 

unsigned 

int 

rsrfull 

l; 



/* Receive registers full 

*/ 

unsigned 

int 

hs 

l; 



/* Handshaking mode enable 

*/ 

unsigned 

int 

xclksrce 

l; 



/* Transm clock source 

*/ 

unsigned 

int 

rclksrce 

l; 



/* Receive clock source 

*/ 

unsigned 

int 

xvaren 

l; 


/* 

Transm data rate signaling 

*/ 

unsigned 

int 

rvaren 

l; 


/* 

Receiv data rate signaling 

*/ 

unsigned 

int 

xfsm 

l; 



/* Transm frame sync mode 

*/ 

unsigned 

int 

rf sm 

l; 



/* Receiv frame sync mode 

*/ 

unsigned 

int 

clkxp 

l; 



/* Transm clock polarity 

*/ 

unsigned 

int 

clkrp 

l; 



/* Receiv clock polarity 

*/ 

unsigned 

int 

dxp 

l; 



/* Transm data polarity 

*/ 

unsigned 

int 

drp 

l; 



/* Receiv data priority 

*/ 

unsigned 

int 

f sxp 

l; 


/* 

Transm frame sync polarity 

*/ 

unsigned 

int 

f srp 

l; 


/* 

Receiv frame sync polarity 

*/ 

unsigned 

int 

xlen 

2; 



/* Transm data word length 

*/ 

unsigned 

int 

rlen 

2; 



/* Receiv data word length 

*/ 

unsigned 

int 

xtint 

l; 

/* 

Transm timer interrupt enable 

*/ 

unsigned 

int 

xint 

l; 



/* Transm interrupt enable 

*/ 

unsigned 

int 

rtint 

l; 

/* 

Receiv timer interrupt enable 

*/ 

unsigned 

int 

rint 

l; 



/* Receiv interrupt enable 

*/ 

unsigned 

int 

xreset 

l; 



/* Transm reset 

*/ 

unsigned 

int 

rreset 

l; 



/* Receiv reset 

*/ 

unsigned 

int 

r_rest 

4; 



/* reserved 

*/ 


} _bitval; 

} SERIAL_PORT_CONTROL; 
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/**************************************************************************/ 
/* STRUCTURE DEFINTION FOR SERIAL PORT RECEIVE/TRANSMIT PORT CONTROL */ 

/* REGISTER */ 

/ ■****************************************************************-**********i 

typedef union 

{ 

unsigned int _intval; 
struct 
{ 


unsigned 

int 

clkfunc 

l; 

/* 

Clock function control 

*/ 

unsigned 

int 

clki_o 

l; 


/* Clock i/o control 

*/ 

unsigned 

int 

clkdato 

l; 

/ 

* Data output on clock 

*/ 

unsigned 

int 

clkdati 

l; 


/* Data input on clock 

*/ 

unsigned 

int 

df unc 

l; 

/* 

Data function control 

*/ 

unsigned 

int 

di_o 

l; 


/* Data i/o control 

*/ 

unsigned 

int 

ddatout 

l; 


/* Data output on data 

*/ 

unsigned 

int 

ddatin 

i; 


/* Data input on data 

*/ 

unsigned 

int 

fsfunc 

l; 

/* Frame 

sync function control 

*/ 

unsigned 

int 

f si_o 

l; 

/* 

Frame sync i/o control 

*/ 

unsigned 

int 

fsdatout 

l; 

/* Data output on frame sync 

*/ 

unsigned 

int 

fsdatin 

l; 

/* Data input on frame sync 

*/ 

unsigned 

int 

r_rest 

20; 


/* reserved 

*/ 


} _bitval; 

} RX_PORT_CONTROL; 

/**************************************************************************/ 
/* STRUCTURE DEFINTION FOR SERIAL PORT RECEIVE/TRANSMIT TIMER CONTROL */ 

/* REGISTER */ 

/************************************-********-****-****-********-****-**********/ 
typedef union 
{ 

unsigned int _intval; 
struct 
{ 


unsigned 

int 

xgo 

l; 

/* Reset and start transmit timer 

*/ 

unsigned 

int 

xhld_ 

l; 

/* Transm timer hold 

*/ 

unsigned 

int 

xcp_ 

l; 

/* Transm clock mode 

*/ 

unsigned 

int 

xclksrc 

i; 

/* Transm clock source 

*/ 

unsigned 

int 

r_4 

l; 

/* reserved 

*/ 

unsigned 

int 

xtstat 

l; 

/* Transmit timer stat 

*/ 

unsigned 

int 

rgo 

l; 

/* Reset and start receive timer 

*/ 

unsigned 

int 

rhld_ 

1; 

/* Receive timer hold 

*/ 

unsigned 

int 

rcp_ 

l; 

/* Receive clock mode 

*/ 

unsigned 

int 

rclksrc 

l; 

/* Receive clock source 

*/ 

unsigned 

int 

r_10 

l; 

/* reserved 

*/ 

unsigned 

int 

rtstat 

l; 

/* Receive timer stat 

*/ 

unsigned 

int 

r_rest 

20; 

/* reserved 

*/ 


} _bitval; 

} RX_TIMER_CONTROL; 
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/**************************************************************************/ 
/* STRUCTURE DEFINTION FOR SERIAL PORT RECEIVE/TRANSMIT TIMER COUNTER */ 

/* REGISTER */ 

/*************************-********-****-****************-****-************-*****/ 
typedef union 
{ 

unsigned int _intval; 
struct 


{ 

unsigned int x_counter:16; 
unsigned int r_counter:16; 
} _bitval; 

} RX_TIMER_COUNTER; 


/* Transmit timer 
/* Receive timer 


counter 

counter 


*/ 

*/ 


/**************************************************************************/ 
/* STRUCTURE DEFINTION FOR SERIAL PORT RECEIVE/TRANSMIT TIMER PERIOD */ 

/* REGISTER */ 

/**************************************************************************/ 
typedef union 
{ 

unsigned int _intval; 
struct 


{ 

unsigned int x_period :16; 
unsigned int r_period :16; 
} _bitval; 

} RX_TIMER_P E RIOD; 


/* Transmit 
/* Receive 


timer period 
timer period 


*/ 

*/ 


/**************************************************************************/ 
/* STRUCTURE DEFINITION FOR SERIAL PORT REGISTERS */ 


typedef struct 
{ 


SERIAL_PORT_CONTROL 

_gctrl; 

/* Serial port global control 

*/ 

unsigned int 

reservedl; 

/* reserved 

*/ 

RX_PORT_CONTROL 

_xctrl; 

/* Transm port control 

*/ 

RX_PORT_CONTROL 

_rctrl; 

/* Receive port control 

*/ 

RX_T I ME R_C ON T RO L 

_rxtctrl; 

/* Receive/transmit timer control 

*/ 

RX_TIMER_COUNTER 

_rxtcounter; 

/* Receive/transmit timer counter 

*/ 

RX_TI ME R_P E RI OD 

_rxtperiod; 

/* Receive/transmit timer period 

*/ 

unsigned int 

reserved2; 

/* reserved 

*/ 

unsigned int 

x_data; 

/* Serial port transmit data 

*/ 

unsigned int 

reserved3[3]; 

/* reserved 

*/ 

unsigned int 

r_data; 

/* Serial port receive data 

*/ 

unsigned int 

reserved4[3]; 

/* reserved 

*/ 


} SERIAL_PORT_REG; 
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/**************************************************************************/ 
/* SERIAL PORT MACROS FOR BIT FIELD DEFINITIONS */ 

/**************************************************************************/ 
/* Serial port macros for global control register integer assignments */ 

/* e.g. SERIAL_PORT_ADDR(0)—>gcontrol = XVAREN | DXP | XLEN_16 set the */ 
/* corresponding bits of serial port 0's global control register */ 

t :**************************************j 


J-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-kt 

#define 

RRDY 

Oxl 

#define 

XRDY 

0x2 

#define 

FSXOUT 

0x4 

#define 

XSREMPTY 

0x8 

#define 

RSRFULL 

0x10 

#define 

HS 

0x20 

#define 

XCLKSRCE 

0x40 

#define 

RCLKSRCE 

0x80 

#define 

XVAREN 

0x100 

#define 

RVAREN 

0x200 

#define 

XFSM 

0x400 

#define 

RFSM 

0x800 

#define 

CLKXP 

0x1000 

#define 

CLKRP 

0x2000 

#define 

DXP 

0x4000 

#define 

DRP 

0x8000 

#define 

FSXP 

0x10000 

#define 

FSRP 

0x20000 

#define 

XLEN_8 

0x00000 

#define 

XLEN_1 6 

0x40000 

#define 

XLEN_2 4 

0x80000 

#define 

XLEN_32 

0x00000 

#define 

RLEN_8 

0x000000 

#define 

RLEN_1 6 

0x100000 

#define 

RLEN_2 4 

0x200000 

#define 

RLEN_32 

0x300000 

#define 

XTINT 

0x400000 

#define 

XINT 

0x800000 

#define 

RTINT 

0x1000000 

#define 

RINT 

0x2000000 

#define 

XRESET 

0x4000000 

#define 

RRESET 

0x8000000 
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#define 

INPUT_PIN 

0 

#define 

OUTPUT_PIN 

1 

#define 

DISABLED 

0 

#define 

ENABLED 

1 

#define 

EXTERNAL 

0 

#define 

INTERNAL 

1 

#define 

FIXED 

0 

#define 

VARIABLE 

1 

#define 

CONTINUOUS 

1 

#define 

STANDARD 

0 

#define 

AC TIVE_HIGH 

0 

#define 

ACTIVE_LOW 

1 

#define 

EIGHT_BITS 

0 

#define 

SIXTEEN_BITS 

1 

#define 

TWENTY_FOUR_BIT£ 

; 2 

#define 

THIRTY_TWO_BITS 

3 

#define 

RESET 

0 

#define 

UN_RESET 

1 

j ************************* 


/* Serial port macros for fsx/dx/clkx control register integer */ 
/* assignments, e.g. SERIAL_PORT_ADDR(0)—>s_x_control = CLKXFUNC I DXFUNC */ 
/* sets the corresponding bits of serial port 0's fsx/dx/clkx control */ 
/* register */ 
/**************************************************************************/ 


#define 

CLKXFUNC 

Oxl 

#define 

CLKXI_0 

0x2 

#define 

CLKXDATOUT 

0x4 

#define 

CLKXDATIN 

0x8 

#define 

DXFUNC 

0x10 

#define 

DXI_0 

0x20 

#define 

DXDATOUT 

0x40 

#define 

DXDATIN 

0x80 

#define 

FSXFUNC 

0x100 

#define 

FSXI_0 

0x200 

#define 

FSXDATOUT 

0x400 

#define 

FSXDATIN 

0x800 


/**************************************************************************/ 

/* Serial port macros 

for fsr/dr/clkr control register integer */ 

/* assignments, e.g. 

SERIAL_PORT_ADDR(0)—>s_r_control = CLKRFUNC I DRFUNC */ 

/* sets 

the corresponding bits of serial port 0's fsr/dr/clkr control */ 

/* register 

*/ 

/**************************************************************************/ 

#define 

CLKRFUNC 

0x1 

#define 

CLKRI_0 

0x2 

#define 

CLKRDATOUT 

0x4 

#define 

CLKRDATIN 

0x8 

#define 

DRFUNC 

0x10 

#define 

DRI_0 

0x20 

#define 

DRDATOUT 

0x40 

#define 

DRDATIN 

0x80 

#define 

FSRFUNC 

0x100 

#define 

FSRI_0 

0x200 

#define 

FSRDATOUT 

0x400 

#define 

FSRDATIN 

0x800 
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tdefine GENERAL_PURPOSE_IO 0 
#define SERIAL_PORT_PIN 1 

/**************************************************************************/ 
/* Serial port macros for receive/transmit timer control register integer */ 
/* assignments, e.g. SERIAL_PORT_ADDR(0)->s_rxt_control = XGO | RGO */ 

/* sets the corresponding bits of serial port 0's receive/transmit control*/ 
/* register */ 

/**************************************************************************/ 
tdefine XGO Oxl 

tdefine XHLD_ 0x2 

tdefine XCP_ 0x4 

tdefine XCLKSRC 0x8 

tdefine XTSTAT 0x20 

tdefine RGO 0x40 

tdefine RHLD_ 0x80 

tdefine RCP_ 0x100 

tdefine RCLKSRC 0x200 

tdefine RSTAT 0x800 

tendif /* tifndef _SERPRT30 */ 
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BA timer30.h Header File 


/*****************************************************************************/ 

/* timer30.h v4.5 */ 

/* Copyright (c) 1991 Texas Instruments Incorporated */ 

/*****************************************************************************/ 
#ifndef _TIMER30 
#define _TIMER30 


#ifndef gcontrol 

#define gcontrol _gctrl._intval 

#endif 


#ifndef gcontrol_bit 

#define gcontrol_bit _gctrl,_bitval 

#endif 


/**************************************************************************/ 

/* MACRO DEFINITIONS FOR TIMER BASE ADDRESS */ 

/**************************************************************************/ 

#define TIMER_ZERO 0 

#define TIMER_ONE 1 

idefine TIMER_BASE 0x808020 

#define TIMER_SIZE 16 

#define TIMER_ADDR(n) ((volatile TIMER_REG *) ((char *) TIMER_BASE \ 

+ (n)*TIMER_SIZE)) 


#define TMR_HLD_0 TIMER_ADDR(0)->gcontrol &= ~HLD_ 

#define TMR_HLD_1 TIMER_ADDR(1)->gcontrol &= ~HLD_ 


/*****************-************************************************-********-*/ 
/* STRUCTURE DEFINITION FOR TIMER GLOBAL CONTROL REGISTER */ 

/**************************************************************************/ 
typedef union 
{ 

unsigned int _intval; 
struct 
{ 


unsigned 

int 

func 

l; 

/* Timer pin function 

*/ 

unsigned 

int 

i_o 

l; 

/* Timer i/o control 

*/ 

unsigned 

int 

datout 

l; 

/* Data output on timer 

*/ 

unsigned 

int 

datin 

l; 

/* Data input on timer 

*/ 

unsigned 

int 

r_4 5 

2; 

/* reserved 

*/ 

unsigned 

int 

go 

l; 

/* Reset and start timer 

*/ 

unsigned 

int 

hld_ 

l; 

/* Counter hold 

*/ 

unsigned 

int 

cp_ 

l; 

/* Clock/pulse mode control 

*/ 

unsigned 

int 

clksrc 

l; 

/* Clock source 

*/ 

unsigned 

int 

inv 

l; 

/* Invert control 

*/ 

unsigned 

int 

tstat 

l; 

/* Timer status 

*/ 

unsigned 
_bitval; 

int 

r_rest 

20; 

/* reserved 

*/ 


} TIMER_CONTROL; 
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/**************************************************************************/ 
/* STRUCTURE DEFINITION FOR TIMER REGISTERS */ 

/**************************************************************************/ 
typedef struct 
{ 


TIMER_CONTROL 

_gctrl; 

/* Timer global control */ 

unsigned int 

reservedl[3]; 

/* reserved */ 

unsigned int 

counter; 

/* Timer counter */ 

unsigned int 

reserved2[3]; 

/* reserved */ 

unsigned int 

period; 

/* Timer period */ 

TIMER_REG; 




/**************************************************************************/ 
/* TIMER MACROS FOR BIT FIELD DEFINITIONS */ 

/**************************************************************************/ 
/* Timer macros for global control register integer assignments */ 

/* e.g. TIMER_ADDR(0)—>gcontrol = FUNC | GO | HLD_ | CLKSRC sets the */ 

/* corresponding bits of timer 0's global control register */ 


y**************************************************************************y 


tdefine 

FUNC 

0x1 

tdefine 

I_0 

0x2 

tdefine 

DATOUT 

0x4 

tdefine 

DATIN 

0x8 

tdefine 

GO 

0x40 

tdefine 

HLD_ 

0x80 

tdefine 

CP_ 

0x100 

tdefine 

CLKSRC 

0x200 

tdefine 

INV 

0x400 

tdefine 

TSTAT 

0x800 


/**************************************************************************/ 


/* Timer macros for global control register bit field assignments */ 
/* e.g. TIMER_ADDR(0)->gcontrol_bit.func = TIMER_PIN; */ 
/* TIMER_ADDR(0)->gcontrol_bit.go = SET; */ 
/* TIMER_ADDR(0)->gcontrol_bit.hld_ = SET; */ 
/* TIMER_ADDR(0)->gcontrol_bit.clksrc = INTERNAL; */ 
/* sets the appropriate bits of timer 0's global control register. */ 


/**************************************************************************/ 

#define TIMER_PIN 1 

#define INPUT 0 

tdefine OUTPUT 1 

#define CLOCK_MODE 1 

#define PULSE_MODE 0 

tdefine INVERT 1 

tdefine NON_INVERT 0 

tdefine EXTERNAL 0 

tdefine INTERNAL 1 


tendif /* tifndef 


TIMER30 */ 
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